Add first-party Packref agent skill with workflow, command boundaries, and README documentation - #22
Conversation
|
@codex review |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 2e333e6be7
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| 1. Check for `.packref/packref-lock.json`, then run `packref list` in an initialized project to | ||
| orient before fetching or removing anything. |
There was a problem hiding this comment.
When this portable skill runs in a repository whose AGENTS.md imposes command, validation, or source-handling constraints, the workflow begins using Packref without telling the agent to discover and follow those instructions. .plans/08-packref-skill.md:93 explicitly requires that reminder; add it before the workflow so repository-local safety rules are not bypassed.
AGENTS.md reference: AGENTS.md:L5-L9
Useful? React with 👍 / 👎.
2e333e6 to
81d5cd8
Compare
69da968 to
2392326
Compare
81d5cd8 to
2b11f85
Compare
2392326 to
ce7b7c9
Compare
|
@codex review |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 2b11f85e8a
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| @@ -0,0 +1,66 @@ | |||
| --- | |||
| name: packref | |||
| description: Inspects the exact dependency source a project references through Packref. Use when tracing a package's implementation, debugging exact-version integration behavior, comparing referenced versions, materializing missing Packref source, or when the user mentions Packref. | |||
There was a problem hiding this comment.
When an ordinary package-management or generic API question merely mentions Packref, this clause tells the agent to activate a source-inspection skill even though .plans/08-packref-skill.md:82-84 explicitly defines those as non-trigger cases. This can inject irrelevant workflow instructions and redirect the agent toward materializing source; narrow the trigger to requests to use Packref or inspect exact dependency source.
AGENTS.md reference: AGENTS.md:L5-L9
Useful? React with 👍 / 👎.
…, and README documentation
2b11f85 to
921cff5
Compare
ce7b7c9 to
6fb49de
Compare
|
@codex review |
|
Codex Review: Didn't find any major issues. Another round soon, please! Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
1 participant
Adds a first-party
packrefskill for coding agents, teaching them how to locate, inspect, and reason about exact dependency sources recorded in a project's Packref lockfile.The skill defines a structured workflow covering lockfile orientation, path resolution for scoped and unscoped packages, tree restoration via
packref install, source traversal, and citation practices. It also documents command boundaries to prevent agents from running destructive or interactive commands without explicit user intent, and provides concrete examples for common scenarios including scoped packages, missing trees, untracked packages, and multi-version comparisons.The README is updated with installation instructions pointing to the skill on skills.sh.