You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/src/content/docs/setup/quick-start.md
+47-16Lines changed: 47 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,10 +29,10 @@ If this step fails, you may need to use a personal access token or run the [inst
29
29
Add a sample from the [agentics](https://github.com/githubnext/agentics) collection. From your repository root run:
30
30
31
31
```bash wrap
32
-
gh aw add githubnext/agentics/weekly-research --pr
32
+
gh aw add githubnext/agentics/daily-team-status --pr
33
33
```
34
34
35
-
This creates a pull request that adds `.github/workflows/weekly-research.md` and the compiled `.lock.yml`. Review and merge the PR into your repo.
35
+
This creates a pull request that adds `.github/workflows/daily-team-status.md` and the compiled `.lock.yml`. Review and merge the PR into your repo.
36
36
37
37
### Step 3 — Add an AI secret
38
38
@@ -65,7 +65,7 @@ For more information, see the [GitHub Copilot CLI documentation](https://github.
65
65
Trigger the workflow immediately in GitHub Actions:
66
66
67
67
```bash wrap
68
-
gh aw run weekly-research
68
+
gh aw run daily-team-status
69
69
```
70
70
71
71
After a few moments, check the status:
@@ -74,35 +74,66 @@ After a few moments, check the status:
74
74
gh aw status
75
75
```
76
76
77
-
Once complete, a new discussion post will be created in your repository with a research report! The report will be automatically generated by the AI based on recent developments in your field, and will be refreshed every week.
77
+
Once complete, a new discussion post will be created in your repository with a daily news! The report will be automatically generated by the AI based on recent activity in your repository.
78
78
79
79
## Understanding Your First Workflow
80
80
81
-
Let's look at what you just added. The weekly research workflow automatically creates a research report every week and posts it as a discussion in your repository, and looks like this:
81
+
Let's look at what you just added. The daily team status workflow automatically creates a status report every weekday and posts it as a discussion in your repository, and looks like this:
82
82
83
83
```aw wrap
84
84
---
85
85
on:
86
86
schedule:
87
-
- cron: "0 9 * * 1" # Every Monday at 9 AM
87
+
- cron: "0 9 * * 1-5"
88
+
workflow_dispatch:
89
+
permissions:
90
+
contents: read
91
+
issues: read
92
+
pull-requests: read
93
+
network: defaults
94
+
tools:
95
+
github:
88
96
safe-outputs:
89
-
create-issue:
97
+
create-discussion:
90
98
---
91
99
92
-
# Weekly Research Report
100
+
# Daily Team Status
93
101
94
-
Create a weekly research report summarizing recent developments in our field:
102
+
Create an upbeat daily status report for the team as a GitHub discussion.
- Team productivity suggestions and improvement ideas
105
+
- Community engagement highlights
106
+
- Project investment and feature recommendations
95
107
96
-
1. Research recent developments and trends
97
-
2. Summarize key findings
98
-
3. Create an issue with the research report
99
-
4. Tag relevant team members
108
+
...
100
109
101
-
Keep the report concise but informative.
110
+
1. Gather recent activity from the repository
111
+
2. Create a new GitHub discussion with your findings and insights
102
112
```
103
113
104
-
This workflow triggers every Monday at 9 AM via cron schedule, has permissions to read repository content and create GitHub issues, and runs AI instructions in natural language to generate research reports.
114
+
This workflow triggers every weekday at 9 AM via cron schedule, has permissions to read repository content and create GitHub discussions, and runs AI instructions in natural language to generate status reports.
115
+
116
+
## Customize Your Workflow
117
+
118
+
Customize your workflow by editing the `.md` file and recompiling with `gh aw compile`.
119
+
You can leverage the help of an agent to customize your workflow without having to learn about the YAML syntax. Run the following command to start an interactive session with GitHub Copilot CLI.
120
+
121
+
```bash wrap
122
+
# install copilot cli
123
+
npm install -g @github/copilot-cli
124
+
# install the custom agent files
125
+
gh aw init
126
+
```
127
+
128
+
Then, run the following to create and edit your workflow:
129
+
130
+
```bash wrap
131
+
# start an interactive session to customize the workflow
132
+
copilot
133
+
> /agent create-agentic-workflow
134
+
> edit @.github/workflows/daily-team-status.md
135
+
```
105
136
106
137
## What's next?
107
138
108
-
Customize your workflow by editing the `.md` file and recompiling with `gh aw compile`. Use [Authoring Agentic Workflows](/gh-aw/setup/agentic-authoring/) to create workflows with AI assistance, explore more samples in the [agentics](https://github.com/githubnext/agentics) repository, and learn about workflow management in [Packaging & Distribution](/gh-aw/guides/packaging-imports/). To understand how agentic workflows work, read [How It Works](/gh-aw/introduction/how-it-works/).
139
+
Use [Authoring Agentic Workflows](/gh-aw/setup/agentic-authoring/) to create workflows with AI assistance, explore more samples in the [agentics](https://github.com/githubnext/agentics) repository, and learn about workflow management in [Packaging & Distribution](/gh-aw/guides/packaging-imports/). To understand how agentic workflows work, read [How It Works](/gh-aw/introduction/how-it-works/).
0 commit comments